The Histogram Tool

Series  You can create, reorder, duplicate, or delete a series in the table. Use the checkboxes to show or hide the series on your histogram. Click the series name you want to provide inputs for. The selected row is highlighted in blue.

	Adds a new series in the chart.
	Moves the selected series one step up in the table. The order in the table determines the order drawn on your chart.
	Moves the selected series one step down in the table. The order in the table determines the order drawn on your chart.
	Duplicates the currently selected series.
	Deletes the selected series.

Series Definition  On the right side of the tab you assign inputs and settings to the selected series.

• Name  Name of the series you added or selected in the table on the left. You can update the name in the text field.
• Source type  Select the source type from the drop-down list. You can select from one of the following: 2D Grid, 3D Grid, 3D Mesh, Marker set, Point set, Polyline set, Tri-mesh, or Wellbore.
• Surface type  Select the surface type from the drop-down list, when the source type is 2D Grid, Marker set, Point set, Polyline set or Tri-mesh.
• Folder  Select the folder from the drop-down list, when the source type is 2D Grid, Marker set, Point set, Polyline set or Tri-mesh.
• Source  Select the source from the drop-down list. The drop-down list shows all sources of the selected 'source type' in your solution. If your source type is 'Wellbore', then a table is shown here, where all the wellbores in the selected wellbore group are listed. Check the wellbores for which you want to plot your data.
• X-Axis property/log type  This selection acts as a filter. Select the property type from the drop-down list. If you choose 'Any...', all your properties for the selected 'Source' object will be available in the following drop-down list.
Important  When you plot multiple data series in a histogram, they must have the same property type (for discrete properties) or quantity (for continuous properties).
• X-Axis property/log  Select the property that you want to plot from the drop-down list. If 'Any...' was chosen for the type, selecting a property here will populate the type field above with the corresponding type.
• Step  Active only if the selected property has multiple realizations or time steps. Select the realization or time step from the drop-down list.
• Filter  Adding a filter is optional. You can add a property-based filter on the selected series. You can use another property to filter the property. Click the 'Edit Filter' icon to open the Filter Tool. The source type selected on the Data tab is populated in the tool.

On this tab you control the X-axis (bin size and range) and Y-axis (normalization) of the histogram.

• Histogram normalization  Controls the Y-axis normalization type of the histogram. Select one of the following options:
  • Count  The Y-axis displays the count (dimensionless) and the histogram bar heights show the number of samples in each bin. The bar heights add up to the total number of samples if the bin range is wide enough to encompass all the data.
  • Probability  The Y-axis displays probability (dimensionless) and the histogram bar heights show the count (number of samples in each bin) divided by the total number of samples in the data set. The bar heights add up to 100% if the bin range is wide enough to encompass all the data.
  • Probability Density  (Only for continuous properties) The Y-axis displays probability density (with units, note that probability density has units equal to the inverse of the X-axis units) which is the amount of probability per increment of the X-axis property. The histogram bar heights show the probability in each bin divided by the bin size. The bin areas are dimensionless and add up to 100% if the bin range is wide enough to encompass all the data.
• Bins  The number of bins in you want to use in the histogram. After defining a histogram, you can type a number in the field, or change the current number with the up or down arrow buttons.
• Bin range  The starting and ending point for the histogram bins. By default, the bin range is the same as the data range. To enter the range manually, uncheck the checkbox adjacent to 'Same as data range'. Specify the Minimum and Maximum values for the range in the fields below.
• Bin size  This field is read-only and displays the bin range divided by the number of bins.

On this tab you can create a distribution model to display on your histogram. Distribution models are only supported for continuous properties. This tab is divided into two parts.

Series  Click the series name you want to assign a distribution model to. The selected row is highlighted in blue.

Distribution Model  Assign a distribution model to your selected series by selecting one from the drop-down list. To create a new distribution model, click the edit icon to open the Distribution Model Tool. After you have created or assigned a distribution model to your series, the tab updates with an overview of the specified settings:

• Name  Displays the distribution model assigned to your series. Select one of the options in the drop-down list. If none are available, create one with the Distribution Model Tool.
• Type  Displays the distribution model type assigned in the Distribution Model Tool. The following distribution types are available: Gaussian, Lognormal, Triangular and Uniform.
Based on distribution model type assigned, specific fields will be displayed showing the parameter values entered in the Distribution Model Tool.

To visualize the distribution model on the histogram, ensure the checkbox next to your series is checked in the 'Series' table on the Distribution Model tab. At the bottom of the Histogram Tool, click Apply to plot the distribution model on the histogram and keep the tool open, or click OK to plot the distribution model on the histogram and close the tool.

In this tab you can format each data series of your histograms and distribution models. On the left side of the tab select the series you want to change or format. The series is highlighted in blue and the right side updates with the relevant settings.

Histogram

• Color  To change the color for your histogram bins.

Distribution Model  You can change the format of the distribution model. The controls are only enabled when you have assigned a distribution model to your series in the Distribution Model tab.

• Color  To change the color of the line, select a color from the drop-down list.
• Style  To change the line style, select a style from the drop-down list.
• Thickness  Defines the line thickness. To change the line thickness, enter a number in the field or change the number with the up or down arrow buttons.

In this tab you can format the chart Axes, Title and Legend. On the left side of the tab select the component you want to change or format. The component is highlighted in blue and the right side updates with the relevant settings.

Axes  You can adjust the scale, axis range, and title of your axis.

• Axis  Select the axis you want to format from the drop-down list. The Y-Axis is not available for histograms.
• Scale  Select Linear or Logarithmic.
  • Reverse  Only available for scatter charts. Use the checkbox to reverse how the axis is displayed (low to high or high to low).
• Axis range  The starting and ending points for the axis. By default the Same as bin range checkbox (for histograms) is checked, meaning the that the minimum and maximum of the axis is taken from the bin range. By default the Auto checkbox (for scatter charts) is checked, meaning that the minimum and maximum of the axis is taken from the series values. To enter the range manually, uncheck the checkbox. Enter the Minimum and Maximum values in the fields below.
• Title  Change the visibility and text of your axis title.
  • Visible  Use the checkbox to show or hide the axis title.
  • Same as property type  To customize your axis title, uncheck the checkbox. Enter your text in the text field.

Title  You can edit and format the title of your chart.

• Visible  Use the checkbox to show or hide the chart title. The chart must be visible to access the color and font settings.
• Same as chart name  To customize you chart title, uncheck the checkbox. Enter your text in the text field.
• Color  To change the color of the chart title, select a color from the drop-down list.
• Font  Click Font... to open a dialog where you can specify which font, style and size to use for the title.

Legend  You can format your legends and their locations on the chart.

• Legend  You can format the main legend of the chart.
  • Visible  Use the checkbox to show or hide the legend on the chart.
  • Location  To change the legend location on the chart, select a location from the drop-down list.
• Color property Legend  You can format the legend of a color property if selected in the Data tab.
  • Visible  Use the checkbox to show or hide the color property legend on the chart.
  • Location  To change the legend location of the color property on the chart, select a location from the drop-down list.
• Appearance  You can format the text and background options of your legend.
  • Text color  To change the color of the legend text, select a color from the drop-down list.
  • Font  Click Font... to open a dialog where you can specify which font, style and size to use for the legend.
  • Background color  To change the background color of the legend, select a color from the drop-down list.
  • Show border  Use the checkbox to show or hide a line border around your legend.